home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 25 / CU Amiga Magazine's Super CD-ROM 25 (1998)(EMAP Images)(GB)(Track 1 of 2)[!][issue 1998-08].iso / CUCD / Programming / ixemul / sdk / man / cat5 / printcap.0 < prev    next >
Encoding:
Text File  |  1998-06-15  |  7.9 KB  |  149 lines

  1.  
  2. PRINTCAP(5)                UNIX Programmer's Manual                PRINTCAP(5)
  3.  
  4. NNAAMMEE
  5.      pprriinnttccaapp - printer capability data base
  6.  
  7. SSYYNNOOPPSSIISS
  8.      pprriinnttccaapp
  9.  
  10. DDEESSCCRRIIPPTTIIOONN
  11.      The PPrriinnttccaapp function is a simplified version of the termcap(5) data base
  12.      used to describe line printers.  The spooling system accesses the
  13.      pprriinnttccaapp file every time it is used, allowing dynamic addition and dele-
  14.      tion of printers.  Each entry in the data base is used to describe one
  15.      printer.  This data base may not be substituted for, as is possible for
  16.      termcap,  because it may allow accounting to be bypassed.
  17.  
  18.      The default printer is normally _l_p, though the environment variable
  19.      PRINTER may be used to override this.  Each spooling utility supports an
  20.      option, --PP _p_r_i_n_t_e_r, to allow explicit naming of a destination printer.
  21.  
  22.      Refer to the _4_._3 _B_S_D _L_i_n_e _P_r_i_n_t_e_r _S_p_o_o_l_e_r _M_a_n_u_a_l for a complete discus-
  23.      sion on how to setup the database for a given printer.
  24.  
  25. CCAAPPAABBIILLIITTIIEESS
  26.      Refer to termcap(5) for a description of the file layout.
  27.  
  28.      NNaammee    TTyyppee    DDeeffaauulltt           DDeessccrriippttiioonn
  29.      af      str     NULL              name of accounting file
  30.      br      num     none              if lp is a tty, set the baud rate
  31.                                        (ioctl(2) call)
  32.      cf      str     NULL              cifplot data filter
  33.      df      str     NULL              tex data filter (DVI format)
  34.      fc      num     0                 if lp is a tty, clear flag bits
  35.                                        (_s_g_t_t_y_._h)
  36.      ff      str     `\f'              string to send for a form feed
  37.      fo      bool    false             print a form feed when device is opened
  38.      fs      num     0                 like `fc' but set bits
  39.      gf      str     NULL              graph data filter (plot(3) format
  40.      hl      bool    false             print the burst header page last
  41.      ic      bool    false             driver supports (non standard) ioctl to
  42.                                        indent printout
  43.      if      str     NULL              name of text filter which does
  44.                                        accounting
  45.      lf      str     _/_d_e_v_/_c_o_n_s_o_l_e      error logging file name
  46.      lo      str     _l_o_c_k              name of lock file
  47.      lp      str     _/_d_e_v_/_l_p           device name to open for output
  48.      mx      num     1000              maximum file size (in BUFSIZ blocks),
  49.                                        zero = unlimited
  50.      nd      str     NULL              next directory for list of queues
  51.                                        (unimplemented)
  52.      nf      str     NULL              ditroff data filter (device independent
  53.                                        troff)
  54.      of      str     NULL              name of output filtering program
  55.      pc      num     200               price per foot or page in hundredths of
  56.                                        cents
  57.      pl      num     66                page length (in lines)
  58.      pw      num     132               page width (in characters)
  59.      px      num     0                 page width in pixels (horizontal)
  60.      py      num     0                 page length in pixels (vertical)
  61.      rf      str     NULL              filter for printing FORTRAN style text
  62.                                        files
  63.      rg      str     NULL              restricted group. Only members of group
  64.  
  65.  
  66.                                        allowed access
  67.      rm      str     NULL              machine name for remote printer
  68.      rp      str     ``lp''            remote printer name argument
  69.      rs      bool    false             restrict remote users to those with
  70.                                        local accounts
  71.      rw      bool    false             open the printer device for reading and
  72.                                        writing
  73.      sb      bool    false             short banner (one line only)
  74.      sc      bool    false             suppress multiple copies
  75.      sd      str     _/_v_a_r_/_s_p_o_o_l_/_l_p_d    spool directory
  76.      sf      bool    false             suppress form feeds
  77.      sh      bool    false             suppress printing of burst page header
  78.      st      str     _s_t_a_t_u_s            status file name
  79.      tf      str     NULL              troff data filter (cat phototypesetter)
  80.      tr      str     NULL              trailer string to print when queue
  81.                                        empties
  82.      vf      str     NULL              raster image filter
  83.      xc      num     0                 if lp is a tty, clear local mode bits
  84.                                        (tty(4))
  85.      xs      num     0                 like `xc' but set bits
  86.  
  87.      If the local line printer driver supports indentation, the daemon must
  88.      understand how to invoke it.
  89.  
  90. FFIILLTTEERRSS
  91.      The lpd(8) daemon creates a pipeline of _f_i_l_t_e_r_s to process files for var-
  92.      ious printer types.  The filters selected depend on the flags passed to
  93.      lpr(1).  The pipeline set up is:
  94.  
  95.            p       pr | if regular text + pr(1)
  96.            none    if      regular text
  97.            c       cf      cifplot
  98.            d       df      DVI (tex)
  99.            g       gf      plot(3)
  100.            n       nf      ditroff
  101.            f       rf      Fortran
  102.            t       tf      troff
  103.            v       vf      raster image
  104.  
  105.      The iiff filter is invoked with arguments:
  106.  
  107.            iiff [--cc] --ww_w_i_d_t_h --ll_l_e_n_g_t_h --ii_i_n_d_e_n_t --nn _l_o_g_i_n --hh _h_o_s_t _a_c_c_t_-_f_i_l_e
  108.  
  109.      The --cc flag is passed only if the --ll flag (pass control characters liter-
  110.      ally) is specified to lpr.  The _W_i_d_t_h function and _l_e_n_g_t_h specify the
  111.      page width and length (from ppww and ppll respectively) in characters.  The
  112.      --nn and --hh parameters specify the login name and host name of the owner of
  113.      the job respectively.  The _A_c_c_t_-_f_i_l_e function is passed from the aaff
  114.      pprriinnttccaapp entry.
  115.  
  116.      If no iiff is specified, ooff is used instead, with the distinction that ooff
  117.      is opened only once, while iiff is opened for every individual job.  Thus,
  118.      iiff is better suited to performing accounting.  The ooff is only given the
  119.      _w_i_d_t_h and _l_e_n_g_t_h flags.
  120.  
  121.      All other filters are called as:
  122.  
  123.            ffiilltteerr --xx_w_i_d_t_h --yy_l_e_n_g_t_h --nn _l_o_g_i_n --hh _h_o_s_t _a_c_c_t_-_f_i_l_e
  124.  
  125.      where _w_i_d_t_h and _l_e_n_g_t_h are represented in pixels, specified by the ppxx and
  126.      ppyy entries respectively.
  127.  
  128.      All filters take _s_t_d_i_n as the file, _s_t_d_o_u_t as the printer, may log either
  129.      to _s_t_d_e_r_r or using syslog(3),  and must not ignore SIGINT.
  130.  
  131. LLOOGGGGIINNGG
  132.      Error messages generated by the line printer programs themselves (that
  133.      is, the lp*  programs) are logged by syslog(3) using the LPR facility.
  134.      Messages printed on _s_t_d_e_r_r of one of the filters are sent to the corre-
  135.      sponding llff file.  The filters may, of course, use syslog themselves.
  136.  
  137.      Error messages sent to the console have a carriage return and a line feed
  138.      appended to them, rather than just a line feed.
  139.  
  140. SSEEEE AALLSSOO
  141.      termcap(5),  lpc(8),  lpd(8),  pac(8),  lpr(1),  lpq(1),  lprm(1)
  142.  
  143.      _4_._3 _B_S_D _L_i_n_e _P_r_i_n_t_e_r _S_p_o_o_l_e_r _M_a_n_u_a_l.
  144.  
  145. HHIISSTTOORRYY
  146.      The pprriinnttccaapp file format appeared in 4.2BSD..
  147.  
  148. 4.2 Berkeley Distribution      December 11, 1993                             3
  149.